home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / a_man / cat1 / cfsstat.z / cfsstat
Encoding:
Text File  |  2001-04-17  |  13.5 KB  |  397 lines
  1.  
  2.  
  3.  
  4. CCCCFFFFSSSSSSSSTTTTAAAATTTT((((1111MMMM))))                                                        CCCCFFFFSSSSSSSSTTTTAAAATTTT((((1111MMMM))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      cfsstat - display Network File System statistics
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ////uuuussssrrrr////eeeettttcccc////ccccffffssssssssttttaaaatttt [ ----CCCCffffbbbbzzzz ] [ _i_n_t_e_r_v_a_l ]
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      _C_f_s_s_t_a_t displays statistical information about the Cache File System
  16.      (CacheFS).  It can also be used to reinitialize this information.  If no
  17.      options are given the default is to print everything and reinitialize
  18.      nothing.  The optional argument _i_n_t_e_r_v_a_l may be used to indicate the
  19.      interval in seconds between display updates in the "full-screen" mode
  20.      described below.  The default value is 1.
  21.  
  22. OOOOPPPPTTTTIIIIOOOONNNNSSSS
  23.      ----CCCC   Display using a "full-screen" form which is updated every _i_n_t_e_r_v_a_l
  24.           seconds.  The values can be displayed as simple totals (_r or "raw"),
  25.           changes during the previous interval (_d or "delta"), or changes
  26.           since a fix moment (_z or "zero").
  27.  
  28.      ----ffff   Display statistics for the file header cache.  This cache is used to
  29.           hold in memory copies of cached file attributes read from the front
  30.           file system.  These statistics are provided primarily to assist in
  31.           tuning the size of the file header cache.
  32.  
  33.      ----bbbb   Display back file system operation statistics.  This option is
  34.           ignored with the ----ffff option.
  35.  
  36.      ----zzzz   Zero (reinitialize) statistics.  Can be combined with any of the
  37.           above options to zero particular sets of statistics after printing
  38.           them.
  39.  
  40. GGGGEEEENNNNEEEERRRRAAAALLLL SSSSTTTTAAAATTTTIIIISSSSTTTTIIIICCCCSSSS
  41.      The meanings of the primary display fields are given below.  These fields
  42.      appear in both the full-screen and default display forms.
  43.  
  44.      iiiinnnnvvvvaaaallll
  45.           the number of cache invalidations
  46.  
  47.      nnnnooooccccaaaacccchhhheeee
  48.           the number of files marked as not being cached
  49.  
  50.      rrrreeeeccccllllaaaaiiiimmmm
  51.           the number of CacheFS vnodes reclaimed by the system
  52.  
  53.      ddddnnnnllllcccchhhhiiiitttt
  54.           the number of lookups which hit in the Directory Name Lookup Cache
  55.           (DNLC)
  56.  
  57.      sssshhhhoooorrrrtttthhhhiiiitttt
  58.           the number of lookups which do not hit in the DNLC but for which an
  59.           existing cnode is found (i.e., the file system dependent data has
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. CCCCFFFFSSSSSSSSTTTTAAAATTTT((((1111MMMM))))                                                        CCCCFFFFSSSSSSSSTTTTAAAATTTT((((1111MMMM))))
  71.  
  72.  
  73.  
  74.           not been reclaimed)
  75.  
  76.      sssshhhhoooorrrrttttmmmmiiiissssssss
  77.           the number of lookups for which there is a front file but for which
  78.           there is no cnode data
  79.  
  80.      llllooooooookkkkuuuupppphhhhiiiitttt
  81.           the number of lookups which find a front file (cache hits)
  82.  
  83.      llllooooooookkkkuuuuppppssssttttaaaalllleeee
  84.           the number of lookups which find a front file with a stale back file
  85.           ID
  86.  
  87.      llllooooooookkkkuuuuppppmmmmiiiissssssss
  88.           the number of lookups for which no front file was found (cache
  89.           misses)
  90.  
  91.      nnnnooooccccaaaacccchhhheeeellllooooooookkkk
  92.           the number of lookups for uncached files or directories
  93.  
  94.      llllooooooookkkkuuuuppppssss
  95.           total number of lookups
  96.  
  97.      rrrreeeeaaaaddddhhhhiiiitttt
  98.           the number of reads which hit in the cache
  99.  
  100.      rrrreeeeaaaaddddmmmmiiiissssssss
  101.           the number of reads which miss (i.e., the read goes to the back
  102.           filesystem)
  103.  
  104.      rrrreeeeaaaaddddssss
  105.           total number of reads
  106.  
  107.      nnnnooooccccaaaacccchhhheeeerrrreeeeaaaaddddssss
  108.           the number of reads on uncached files
  109.  
  110.      rrrreeeeaaaaddddeeeerrrrrrrroooorrrrssss
  111.           the number of read errors (either reading from the front or back
  112.           file)
  113.  
  114.      wwwwrrrriiiitttteeeessss
  115.           total number of writes
  116.  
  117.      nnnnooooccccaaaacccchhhheeeewwwwrrrriiiitttteeee
  118.           the number of writes to uncached files
  119.  
  120.      wwwwrrrriiiitttteeeeeeeerrrrrrrroooorrrrssss
  121.           the number of write errors (either writing to the front or back
  122.           file)
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. CCCCFFFFSSSSSSSSTTTTAAAATTTT((((1111MMMM))))                                                        CCCCFFFFSSSSSSSSTTTTAAAATTTT((((1111MMMM))))
  137.  
  138.  
  139.  
  140.      aaaassssyyyynnnnccccrrrreeeeqqqqssss
  141.           total number of requests to the CacheFS asynchronous operation
  142.           daemon(s)
  143.  
  144.      rrrreeeeppppllllaaaacccceeeemmmmeeeennnnttttssss
  145.           total number of file replacements (files removed from the cache to
  146.           make room for new files)
  147.  
  148.      rrrrddddiiiirrrrhhhhiiiitttt
  149.           the number of readdir requests which hit in the cache
  150.  
  151.      rrrrddddiiiirrrrmmmmiiiissssssss
  152.           the number of readdir requests which miss
  153.  
  154.      rrrreeeeaaaaddddddddiiiirrrrssss
  155.           total number of readdir requests
  156.  
  157.      sssshhhhoooorrrrtttt rrrrddddlllliiiinnnnkkkk
  158.           the number of reads of symbolic links which get data from the file
  159.           header and so do not require a further read of the front file
  160.  
  161.      lllloooonnnngggg rrrrddddlllliiiinnnnkkkk
  162.           the number of reads of symbolic links which must get data from the
  163.           front file
  164.  
  165.      vvvvnnnnooooppppssss
  166.           total number of vnode operations
  167.  
  168.      vvvvffffssssooooppppssss
  169.           total number of vfs operations
  170.  
  171.      bbbbaaaacccckkkk vvvvnnnnooooppppssss
  172.           total number of vnode operations to the back file system
  173.  
  174.      bbbbaaaacccckkkk vvvvffffssssooooppppssss
  175.           total number of vfs operations to the back file system
  176.  
  177.      ggggeeeettttbbbbaaaacccckkkkvvvvpppp
  178.           the total number of times a back vnode must be gotten using the file
  179.           ID
  180.  
  181.      oooobbbbjjjjcccchhhheeeecccckkkkssss
  182.           total number of cache consistency checks
  183.  
  184.      bbbbaaaacccckkkk cccchhhheeeecccckkkkssss
  185.           the number of cache consistency checks which go to the back file
  186.           system
  187.  
  188.      oooobbbbjjjjiiiinnnniiiittttssss
  189.           total number of cache object initializations
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. CCCCFFFFSSSSSSSSTTTTAAAATTTT((((1111MMMM))))                                                        CCCCFFFFSSSSSSSSTTTTAAAATTTT((((1111MMMM))))
  203.  
  204.  
  205.  
  206.      oooobbbbjjjjmmmmooooddddssss
  207.           total number of cache object modifications (this occurs for writes)
  208.  
  209.      oooobbbbjjjjiiiinnnnvvvvaaaallllssss
  210.           total number of cache object invalidations
  211.  
  212.      nnnneeeewwwwccccnnnnooooddddeeeessss
  213.           number of new cnodes created
  214.  
  215.      mmmmaaaakkkkeeeeccccnnnnooooddddeeee
  216.           number of calls to makecachefsnode (the function which looks up and
  217.           creates cnodes)
  218.  
  219.      nnnnooooccccnnnnooooddddeeee
  220.           the number of times makecachefsnode returns ENOENT when given a back
  221.           file ID and no front and back vnodes
  222.  
  223.      ccccnnnnooooddddeeeehhhhiiiitttt
  224.           the number of times a cnode was found (not created) by
  225.           makecachefsnode
  226.  
  227.      ccccnnnnrrrreeeessssttttaaaarrrrtttt
  228.           the number of times cnode lookup has been restarted due to a cnode
  229.           bein destroyed or failure to get the vnode
  230.  
  231.      ccccnnnnllllooooooookkkkaaaaggggaaaaiiiinnnn
  232.           the number of times cnode lookup has been restarted after creating a
  233.           new cnode
  234.  
  235.      ccccnnnnttttoooossssssss
  236.           the number of cnodes freed due to duplication
  237.  
  238.      rrrreeeeccccllllaaaaiiiimmmm rrrraaaacccceeee
  239.           the number of collisions between cnode lookup and reclaiming
  240.  
  241.      ddddeeeessssttttrrrrooooyyyy rrrraaaacccceeee
  242.           the number of collisions between cnode lookup and destruction
  243.  
  244. BBBBAAAACCCCKKKK FFFFIIIILLLLEEEE SSSSYYYYSSSSTTTTEEEEMMMM OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNNSSSS
  245.      In addition to the primary fields, the full-screen form offers some
  246.      additional fields.  These fields provide a summary of back file system
  247.      operations.  These appear in all of the display modes (delta, zero, or
  248.      raw) but are most useful in "delta" mode.
  249.  
  250.      The statistics are not printed if the ----ffff option is supplied.
  251.  
  252.      llllkkkkuuuu  the number of lookups
  253.  
  254.      ffffssssyyyy  the number of file syncs
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.                                                                         PPPPaaaaggggeeee 4444
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268. CCCCFFFFSSSSSSSSTTTTAAAATTTT((((1111MMMM))))                                                        CCCCFFFFSSSSSSSSTTTTAAAATTTT((((1111MMMM))))
  269.  
  270.  
  271.  
  272.      rrrrddddllll  the number of readlinks
  273.  
  274.      aaaacccccccc  the number of access checks
  275.  
  276.      ggggeeeetttt  the number of getattrs
  277.  
  278.      sssseeeetttt  the number of setattrs
  279.  
  280.      cccclllloooo  the number of closes
  281.  
  282.      ooooppppnnnn  the number of opens
  283.  
  284.      rrrrdddddddd  the number readdirs
  285.  
  286.      ccccrrrreeee  the number of creates
  287.  
  288.      rrrreeeemmmm  the number of removes
  289.  
  290.      llllnnnnkkkk  the number of links
  291.  
  292.      rrrreeeennnn  the number of renames
  293.  
  294.      mmmmkkkkdddd  the number of mkdirs
  295.  
  296.      rrrrmmmmdddd  the number of rmdirs
  297.  
  298.      ssssyyyymmmm  the number of symlinks
  299.  
  300.      ffffrrrrllll  the number of file locks
  301.  
  302.      rrrrddddvvvv  the number of reads
  303.  
  304.      wwwwrrrrvvvv  the number of writes
  305.  
  306. FFFFIIIILLLLEEEE HHHHEEEEAAAADDDDEEEERRRR CCCCAAAACCCCHHHHEEEE SSSSTTTTAAAATTTTIIIISSSSTTTTIIIICCCCSSSS
  307.      _C_f_s_s_t_a_t can also be instructed to display statistics for the file header
  308.      cache.  The fields displayed are described below.
  309.  
  310.      hhhhiiiittttssss the percentage of file header reads that hit in the cache
  311.  
  312.      mmmmiiiisssssssseeeessss
  313.           the percentage of file header reads that miss in the cache
  314.  
  315.      rrrreeeeaaaaddddssss
  316.           total number of file header reads
  317.  
  318.      wwwwrrrriiiitttteeeessss
  319.           total number of file header writes
  320.  
  321.      ccccaaaacccchhhheeee eeeennnntttteeeerrrr
  322.           number of file headers entered into the cache
  323.  
  324.  
  325.  
  326.  
  327.                                                                         PPPPaaaaggggeeee 5555
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334. CCCCFFFFSSSSSSSSTTTTAAAATTTT((((1111MMMM))))                                                        CCCCFFFFSSSSSSSSTTTTAAAATTTT((((1111MMMM))))
  335.  
  336.  
  337.  
  338.      ccccaaaacccchhhheeee rrrreeeemmmmoooovvvveeee
  339.           number of file headers removed from the cache
  340.  
  341.      LLLLRRRRUUUU eeeennnntttteeeerrrr
  342.           number of file headers placed onto the LRU list
  343.  
  344.      LLLLRRRRUUUU rrrreeeemmmmoooovvvveeee
  345.           number of file headers removed from the LRU list
  346.  
  347.      ppppuuuurrrrggggeeeessss
  348.           number of file headers purged from the cache
  349.  
  350.      rrrreeeelllleeeeaaaasssseeeessss
  351.           number of file header releases
  352.  
  353. FFFFIIIILLLLEEEESSSS
  354.      /unix       system namelist
  355.      /dev/kmem   kernel memory
  356.  
  357. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  358.      cachefs(4), osview(1), nfsstat(1M), sar(1), systune(1M)
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.                                                                         PPPPaaaaggggeeee 6666
  394.  
  395.  
  396.  
  397.